Reports whether a given handle is a control handle.

Boolean IsValidControlHandle (
    ControlRef theControl
);

theControl

A value of type ControlHandle. Pass the handle to be examined.

function result

true if the specified handle is a valid control handle; otherwise, false.

DISCUSSION

The IsValidControlHandle function confirms whether a given handle is a valid control handle, but it does not check the validity of the data contained in the control itself.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)